
%\def\thefootnote{\fnsymbol{footnote}}
%\setlength{\parindent}{0pt}
%\setlength{\parskip}{0.5\baselineskip plus 2pt minus 1pt}
%\begin{document}

\subsubsection{Name}

nzls - Textual ls-like command for file time navigation.

\subsubsection{Synopsis}



nzls [ {\sc OPTION} ]... [ {\sc SIMDIR}\_{\sc PATH} ]

\subsubsection{Description}



nzls Simulates a new date-based folder hierarchy over the working
directory in order to help locate files in time. (Needles to say that
no real modification or permanent change is done to the real hierarchy
bleed by the user).


If no date is chosen by the user the command lists a sort of simulated
directories that represents the date range of the files inside the
working directory and all it's sub-folders (disregarding the established 
directory structure). The values shown by the command are the
possible options that the user might choose in each level
({\sc YEAR}/{\sc MONTH}/{\sc DAY}).


When a full date/{\sc SIMDIR} path is given or has been set by the nzcd , the
command lists all the files matching the selected date.

\subsubsection{Options}


\begin{itemize}
\item {-t, --time {\sc DATE}\_{\sc TYPE}}


The type of date used in the organization. Currently the fol\\lowing options are being accepted:


ctime Time of last status change.


atime Last access time.


mtime Last modification time. This is the default type, if none
is set that's the one that is being used to search and create
the simulated directories and to sort/select the files by date.

\item {-h, --help}
Displays a help message for the correct usage of the command

\item {-l, --long-path}
Prints the full path (starting form the working directory) of
each file found in order to help the users locate what they
search in his system.

\item {-f, --force} 
Force the display of the files even when the {\sc SIMDIR} is not set
or not completely chosen. This means that a partial date may be
used in order to display the files in a wider range.

\end{itemize}

\subsubsection{Examples}



The easiest way to use the nzls and ``navigate'' through time and directories is using the {\sc SIMDIR} feature. In order to do so just execute the
command without any command-line argument given (except the desired
{\sc OPTIONS} of course). Then you'll be presented with a simulated time organized directory structure with the corresponding files within.


For instance, supposing that we have in our Current Working Directory
the following files and folder structure:
\begin{itemize}
\item {foo.bin -$>$ Not touched since 2007-01-30}

\item {snorl/ho.txt -$>$ Not touched since 1994-08-24}

\item {snorl/smunch/hop.txt -$>$ Not touched since 2007-07-01}

\end{itemize}


Now we will reproduce the nzls behavior using the {\sc SIMDIR} feature:



\begin{itemize}
\item [$>$]nzls -t=''mtime'' 

\item [$>$]1994

\item [$>$]2007

\item [$>$]nzls -t=''mtime'' 2007/

\item [$>$]1

\item [$>$]7  

\item [$>$]nzls -t=''mtime'' 2007/01/

\item [$>$]30

\item [$>$]nzls -t=''mtime'' 2007/01/30/

\item [$>$]foo.bin

\end{itemize}


If the concrete date is known, you can avoid the process of selecting
it with the {\sc SIMDIR} feature and provide it. For example, to list all the
files modified the 17th of July 1997 in the current path (and all it's
sub-folders) just do:

\begin{itemize}

\item [$>$]nzls 1997/7/17

\end{itemize}

To see all the files accessed the same date:

\begin{itemize}

\item [$>$]nzls $-$$-$time=''atime'' 1997/7/17

\end{itemize}

In order to display the files in a wider time interval than a single
day, the user can use the --force option. So to list all the files
within the working directory (and all it's sub-folders) that has been
modified in the whole year 2007 do:

\begin{itemize}

\item [$>$]nzls $-$$-$force 2007

\end{itemize}

\subsubsection{Bugs}



It's known that if the user kills the program (Ctr-c) maybe because the
query is taking too much time, an inconsistency may be generated and
further queries in the same directory may behave unexpectedly. To solve
that, please re-execute the nzls in a folder different than the current
and let it finish.


Please report any other bug to the author's mail address.

\subsubsection{Author}



Written by Adrià Ribatallada Torelló mail: $<$nohopensonillegir@hot\\
mail.com$>$

\subsubsection{See Also}



{\sf nzcd(1)} {\sf nzpwd(1)} {\sf nimitzrc(5)}

%emplena d'espais buits fins al final de la pàgina
\clearpage
\vfill

%\end{document}
